home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d10 / ps1410.arc / README.DOC < prev    next >
Text File  |  1990-10-31  |  11KB  |  245 lines
  1. Wed  Oct 31, 1990  19:01:39
  2.  
  3.              
  4.                ╔═══════════════════════════════════════════════════╗
  5.                ║                                                   ║
  6.                ║               Personal Calendar (PC)              ║ 
  7.                ║                      for DOS                      ║
  8.                ║                                                   ║
  9.                ║                    SOURCE CODE                    ║
  10.                ║                                                   ║
  11.                ║    (c) Copyright 1985-1990, Paul Muñoz-Colman.    ║
  12.                ║                All rights reserved.               ║
  13.                ║                                                   ║
  14.                ║                   Shareware $25.                  ║
  15.                ║                                                   ║
  16.                ╚═══════════════════════════════════════════════════╝
  17.  
  18.                               Introductory Information
  19. Hello!
  20.  
  21. Introduction.  
  22. ------------
  23. Personal Calendar (PC) is a popular, and useful program which I have worked on
  24. since early 1985.  PC is a deluxe clock, calendar, appointment reminder, and
  25. notepad.  It runs as a normal DOS program or as a TSR (pop up / pop down
  26. program under DOS 3.x or later); this is your choice. If you use it as a TSR,
  27. it will shrink down to 6,000 bytes of DOS memory when it becomes resident if 
  28. either EMS memory or disk are used for swapping.
  29.  
  30.  
  31. Implementation.
  32. --------------
  33.  
  34. PC is written in Microsoft Professional Development System (PDS) BASIC 7.10
  35. (the BC command-line compiler, not the QuickBASIC Extended (QBX) environment),
  36. and uses the following MicroHelp support packages:
  37.  
  38.    .  Stay-Res Plus (version 4.00),
  39.    .  Mach2         (version 2.51),
  40.    .  QB/Pro 1-4    (version 1.50), and
  41.    .  QB/Pro 7      (version 1.10)
  42.  
  43. All of the MicroHelp libraries are BC 7-compatible.  The program is bound by
  44. segmented-executable LINK version 5.10.
  45.  
  46.  
  47. Packaging.
  48. ---------
  49. The PC program source code on this diskette or Bulletin Board System (BBS)
  50. download is contained on a compressed archive file.  The file is in one of two
  51. forms:  either a self-extracting archive or a normal archive file.  This
  52. archive was created with PKWARE's shareware ZIP compression software, version
  53. 1.10.  The file is named as follows --
  54.  
  55.       PSnnnn.EXE - Self-extracting ZIP file                  [diskette version]
  56.   or  PSnnnn.ZIP - Normal ZIP file (you need PKUNZIP to extract)  [BBS version]
  57.  
  58. "nnnn" is the version number (i.e. PS1410.EXE is the self-extracting archive
  59. for Personal Calendar source code Version 14.10; PS1410.ZIP is the normal ZIP
  60. file).  (There is no difference in the file content of the two formats; just in
  61. the way you extract information from them.)
  62.  
  63. Extract Process.
  64. ---------------
  65. To extract this source code (either new or as an update), just type the name of
  66. the self-extracting .EXE file, including the correct version number.  If you
  67. have the .ZIP file, use PKUNZIP instead.  Examples for the self-extracting
  68. .EXE file:
  69.  
  70.       PS1410                  Extracts to your current directory
  71.  or   PS1410 d:\path          Extracts to drive and subdirectory "d:\path"
  72.  or a:PS1410                  Extracts from a floppy to your current drive
  73.  or   PS1410 /h               Help with PKWARE's self-extracting file program
  74.  
  75. Examples for the .ZIP file (note that you must obtain your own version of
  76. PKUNZIP from your local shareware supplier):
  77.  
  78.       PKUNZIP PS1410          Extracts to your current directory
  79.  or   PKUNZIP PS1410 d:\path  Extracts to drive and subdirectory "d:\path"
  80.  or   PKUNZIP a:PS1410        Extracts from a floppy to your current drive
  81.  or   PKUNZIP /h              Help with PKWARE's PKUNZIP program
  82.  
  83.  
  84. Installation Files.
  85. ------------------
  86. When you extract Personal Calendar, the following files will be extracted and
  87. written to the drive and directory you specified above:
  88.  
  89. WHATSNEW CAL   -- Recent Corrections, Enhancements, and Changes
  90. REGISTER CAL   -- Registration information, form, license, and fees
  91. README   DOC   -- This Information File (A copy of READ.ME on the diskette)
  92. CAL      MAP   -- Calendar CAL.EXE File Load Map
  93. CAL      MP2   -- Calendar Disk Statistics from EXEMOD
  94. CAL      SIZ   -- Calendar Disk Size Statistics
  95. CAL1     BAS   -- Calendar Source Part 1  (Tabs in 6,11,16,21,26,...)
  96. CAL2     BAS   -- Calendar Source Part 2  (Tabs in 6,11,16,21,26,...)
  97. CAL3     BAS   -- Calendar Source Part 3  (Tabs in 6,11,16,21,26,...)
  98. CAL4     BAS   -- Calendar Source Part 4  (Tabs in 6,11,16,21,26,...)
  99. CAL5     BAS   -- Calendar Source Part 5  (Tabs in 6,11,16,21,26,...)
  100. CAL6     BAS   -- Calendar Source Part 6  (Tabs in 6,11,16,21,26,...)
  101. CALU     BAS   -- Calendar Source Dummy User Validation Module
  102. CAL1     BI    -- Calendar Source $INCLUDE File  (Tabs in 6,11,16,21,26,...)
  103. MAKECAL  BAT   -- Batch File to Compile, Link, and Go (see note below)
  104. PRINTCAL BAT   -- Batch File to Print Calendar Source (You must set tabs)
  105.  
  106. To rebuild Personal Calendar, you must have Microsoft Professional Development
  107. System (PDS) BASIC 7.10 and MicroHelp's Mach2 (version 2.51), Stay-Res Plus
  108. (version 4.00), and QB/Pro 1-4 (version 1.50)  packages which are compatible
  109. with BC 7.  MicroHelp (404-552-0565) can supply you with the add-on libraries
  110. for a license fee.
  111.  
  112. The user validation module in the source code (CALU.BAS) is a dummy module and
  113. will not perform serial number validation.  The actual validation module is
  114. not available.  CALU.OBJ (when you compile it) must be linked with the rest of
  115. the program as shown in the MAKECAL.BAT file.
  116.  
  117. Update Procedure. 
  118. ----------------
  119. If you already have an older version of Personal Calendar in the directory to
  120. which you are writing, you will receive messages from PKSFX or PKUNZIP of the
  121. following type:
  122.  
  123.    PKSFX (R)   FAST!   Self Extract Utility   Version 1.1   03-15-90
  124.    Copr. 1989-1990 PKWARE Inc. All Rights Reserved. PKSFX/h for help
  125.    PKSFX Reg. U.S. Pat. and Tm. Off.
  126.  
  127.    Searching EXE: C:/PS1410.EXE - Personal Calendar (Executable), Version 14.10
  128.    PKSFX: Warning! file: CAL1.BAS already exists.  Overwrite (y/n)?
  129.  
  130. Just answer "y" for each file for which the message appears, and the old
  131. version will be replaced by the new one.
  132.  
  133.  
  134. Cleanup.
  135. -------
  136. After extracting the files, you may delete the PSnnnn.EXE or PSnnnn.ZIP file,
  137. if you wish.
  138.  
  139.  
  140. Program Operation.
  141. -----------------
  142. To run Personal Calendar, at the DOS prompt, type --
  143.  
  144.         CAL
  145.  
  146.  
  147. Documentation.
  148. -------------
  149. For more information, consult the help text once you are within the program. 
  150. The help text may be printed from within the program.  New features in recent
  151. versions of Personal Calendar are documented in the WHATSNEW.CAL file, which
  152. may be printed from DOS with the PRINT command.
  153.  
  154.  
  155. Distribution Policy.
  156. -------------------
  157. You may distribute Personal Calendar source code in its original archive format
  158. (PSnnnn.EXE or PSnnnn.ZIP) ONLY.  If you a BBS operator, you are allowed to
  159. post PC for download, whether or not your BBS is a for-fee service.  If you are
  160. disk vendor see file REGISTER.CAL for details.
  161.  
  162. You may not distribute the CALSER.DAT registration file to anyone not covered
  163. by your software license.
  164.  
  165.  
  166. Registration Payment and Evaluation Period.
  167. ------------------------------------------
  168. You may try Personal Calendar for a 30-day period on an evaluation basis at no
  169. charge.  If you like the program and wish to keep it, you must pay the $25
  170. registration fee, returning the ORDER FORM and SOFTWARE LICENSE according to
  171. the instructions in REGISTER.CAL.  Note that the source code is licensed for
  172. an additional $25.  Be sure to specify 5-1/4" or 3-1/2" diskettes.  The program
  173. diskette which I send you will contain your personal validation file CALSER.DAT
  174. to enable the registered mode.
  175.  
  176.  
  177. In Closing.
  178. ----------
  179. Enjoy Personal Calendar!  I welcome discussion of my program design or any
  180. related topic, if you are interested.  If you wish the executable program, you
  181. can find it on your BBS as file PCnnnn.ZIP, or order it from me when you
  182. register.
  183.  
  184.  
  185. ------------------------------------------------------------------------------
  186.  
  187.       Paul Muñoz-Colman                      Phone numbers:
  188.       11645 Charter Oak Ct., #201            (703)  435-1110 -- home
  189.       Reston, VA  22090-4526                 (703)  487-8658 -- office
  190.   
  191.  or   71141,1224 on CompuServe (IBMSYS and MSLANG forums)
  192.                  on PCMagNet (UTILFORUM)
  193.  
  194.  or   on the following EXCELLENT bulletin boards --
  195.  
  196. ------------------------------------------------------------------------------
  197.  
  198.     THE ELUSIVE DIAMOND                   THE VOR & MOTHERBOARD BBSs
  199.     (703) 323-6423 & -1782                (707) 778-8944 & -8841
  200.     Gregg Snyder, SysOp                   Vern & Julie Buerg, SysOps
  201.  
  202.     THE BREAK EAST BBS                   (The phone number of the new
  203.     (703) 680-9269                        BREAK WEST will be published when
  204.     Bruce Jackson, SysOp                  available, Jim Thompson, SysOp)
  205.  
  206. ------------------------------------------------------------------------------
  207.  
  208. Leave a message for me, if you wish.  I make a point of placing recent and
  209. major upgrades on these boards, and when released, they are available there for
  210. download.
  211.  
  212. ------------------------------------------------------------------------------
  213.  
  214. With the exception of this README.DOC file (or READ.ME on the diskette), the
  215. contents of this ZIP file are:
  216.  
  217. ------------------------------------------------------------------------------
  218.  
  219.  
  220. PKZIP (R)   FAST!   Create/Update Utility   Version 1.1   03-15-90
  221. Copr. 1989-1990 PKWARE Inc.  All Rights Reserved.  PKZIP/h for help
  222. PKZIP Reg. U.S. Pat. and Tm. Off.
  223.  
  224. Searching ZIP: PS1410.ZIP - Personal Calendar (Source), Version 14.10
  225.  
  226.  Length  Method   Size  Ratio   Date    Time   CRC-32  Attr  Name
  227.  ------  ------   ----- -----   ----    ----   ------  ----  ----
  228.    3438  Implode   1091  69%  10-31-90  19:01  9db14d64 --w  CAL.MAP
  229.     737  Implode    372  50%  10-31-90  19:01  175885a5 --w  CAL.MP2
  230.     643  Implode    325  50%  10-31-90  19:01  8600b76f --w  CAL.SIZ
  231.   34858  Implode   9154  74%  10-31-90  19:01  48e9a691 --w  CAL1.BAS
  232.   39135  Implode  12018  70%  10-31-90  19:01  0821caed --w  CAL1.BI
  233.   71374  Implode  18103  75%  10-31-90  19:01  39e59ed9 --w  CAL2.BAS
  234.   76913  Implode  19925  75%  10-31-90  19:01  544c6c71 --w  CAL3.BAS
  235.   78129  Implode  19442  76%  10-31-90  19:01  a1b59351 --w  CAL4.BAS
  236.   68423  Implode  16543  76%  10-31-90  19:01  1927036a --w  CAL5.BAS
  237.   93218  Implode  25032  74%  10-31-90  19:01  523224c9 --w  CAL6.BAS
  238.    1985  Implode    753  63%  10-31-90  19:01  bf2fdef7 --w  CALU.BAS
  239.     698  Implode    451  36%  10-31-90  19:01  121ae731 --w  MAKECAL.BAT
  240.     313  Shrunk     209  34%  10-31-90  19:01  48b49211 --w  PRINTCAL.BAT
  241.   21391  Implode   8536  61%  10-31-90  19:01  b563e984 --w  WHATSNEW.CAL
  242.   21940  Implode   8270  63%  10-31-90  19:01  62543c99 --w  REGISTER.CAL
  243.  ------          ------  ---                                 -------
  244.  513195          140224  73%                                      15
  245.